docs: Reference the git docs on references

diff --git a/docs/manual/repo.md b/docs/manual/repo.md
index f636d574212e4545bb2eff0b41611153209a9a93..3a9e8c9abab09f1938d8446f41e593110e6af4e6 100644 (file)
--- a/docs/manual/repo.md
+++ b/docs/manual/repo.md
@@ -74,9 +74,13 @@ command, it will operate on the system repository.
 
 ## Refs
 
-Like git, OSTree uses "refs" to which are text files that point to
-particular commits (i.e. filesystem trees).  For example, the
-gnome-ostree operating system creates trees named like
+Like git, OSTree uses the terminology "references" (abbreviated
+"refs") which are text files that name (refer to) to particular
+commits.  See the
+[Git Documentation](https://git-scm.com/book/en/v2/Git-Internals-Git-References)
+for information on how git uses them.  Unlike git though, it doesn't
+usually make sense to have a "master" branch.  There is a convention
+for references in OSTree that looks like this:
 `exampleos/buildmaster/x86_64-runtime` and
 `exampleos/buildmaster/x86_64-devel-debug`.  These two refs point to
 two different generated filesystem trees.  In this example, the